June 2000

Extending Printing Dialog Boxes in Mac OS X (Preliminary) NEW

This draft document describes how to use the Mac OS X Printing Manager's printing dialog extension (PDE) mechanism to extend the Print and Page Setup dialog boxes. It includes overview, sample code, and API sections. The PDE mechanism provides great flexibility in extending printing dialogs, while optimizing compatibility with new printing features available in Mac OS X. It works only for Carbon applications running in Mac OS X.

May 2000

The new Carbon Developer Documentation suite introduced for the
Worldwide Developers Conference.

In addition to the April material (listed below) supplied on the
Developer Preview 4 release of Mac OS X, this suite introduces several
new documents, including

• Adopting the Carbon Printing Manager
• Extending Printing Dialog Boxes in Mac OS X (Preliminary)
• Adopting the Aqua Interface (which supersedes the previously released Aqua Layout Guidelines)

Several revised documents are available here for the first time,
including

• Carbon Specification (including hundreds of new Carbon porting notes)
• Inside Mac OS X: System Overview
• Implementing Security Features Using Keychain
• Transferring Files With the URL Access Manager
• Multilingual Text Editor API Preliminary Documentation
• File Manager Reference (which now includes descriptions of the APIs introduced in Mac OS 9)
• Reference material updated with compatibility information for ALL managers supported in Carbon

Please note that the definitive source of Carbon API compatibility
information is the Carbon Specification. The Carbon Specification lists
the most up-to-date Carbon inclusion status, porting notes, and
availability information. Reports returned from the Carbon Dater tool
use the same data used to produced the Carbon Specification. However, it
currently takes from one to four weeks for the latest data to propogate
into the Inside Carbon reference pages.

The Carbon Developer Documentation suite is a work in progress and is
being updated continually. The first goal of this site is to provide
comprehensive reference information to assist you in Carbonizing your
existing Mac OS 8 and 9 applications. The next goal is to provide more
conceptual and tutorial information to assist developers new to the Mac
OS, and to update Inside Macintosh conceptual and tutorial information
for Carbon. If you don't find conceptual or tutorial information for a
particular manager in the Carbon Developer Documentation suite, you
might find relevant information on the Mac OS 8 and 9 Developer
Documentation site at: http://developer.apple.com/techpubs/macos8/mac8.html

April 2000

The introduction of the Carbon Developer Documentation site for release on the Tools SDK accompanying the Developer Preview Release 4 of Mac OS X. This site introduces several new documents including

• Inside Mac OS X: System Overview
• Inside Carbon: Plug-In Services
• Inside Carbon: Utility Services
• Inside Carbon: Matching Fonts With FontSync
• Introduction to the Carbon Event Manager
• Carbon Event Manager Preliminary API Reference

Several documents receiving substantial revision are published here for the first time, including

• Inside Carbon: Carbon Printing Manager Reference
• Inside Carbon: NSL Manager Reference
• Inside Carbon: Apple Event Manager Reference
• Aqua Application Layout Guidelines
• Carbon Porting Guide

All of the API reference material contains new Carbon information never before published in Inside Macintosh documentation. This new information includes

• Carbon compatibility overviews for all technologies
• Carbon inclusion status for every function: whether the function is fully supported in Carbon, is supported but is not recommended, is supported but has changed in some manner, or is unsupported Carbon Porting Notes to assist you in replacing functions that are not entirely supported in Carbon
• Availability information, indicating the earliest software releases that support particular functions
• Carbon declarations in the C language, replacing older Pascal declarations
• Alphabetical lists of API elements for each manager, to complement usage groupings of these elements

This reference material has also been tagged for easier searching by Apple Help. In all, reference material for the following technologies is available on this release of the Carbon Developer Documentation site:

Alias Manager
Appearance Manager
Apple Event Manager
Base Services
Bundle Services
Carbon Printing Manager
Code Fragment Manager
Collection Services
Component Manager
Date, Time, and Measurement Utilities
Debugger Services
Dialog Manager
Display Manager
Finder Interface
Folder Manager
Font Manager
FontSync
Game Sprockets
Icon Utilities and Services
Keychain Manager
List Manager
Mathematical and Logical Utilities
Memory Management Utilities
Memory Manager
Menu Manager
Mixed Mode Manager
Multiprocessing Services
Navigation Services
Notification Manager
NSL Manager
Picture Utilities
Plugin Services
Process Manager
Property List Services
QuickDraw
QuickDraw Text
Scrap Manager
Script Manager
Sound Manager
Speech Synthesis Manager
String Services
Text Utilities
TextEdit
Thread Manager
Time Manager
Translation Manager
Utility Services
Window Manager

Note that this documentation site is a work-in-progress and will be continually updated with the latest publicly available information about Carbon. Future updates will include

• API reference material for all Carbon-compliant technologies
• additional conceptual and tutorial information to further assist you in revising your classic Mac OS applications for Carbon and creating new ones
• corrections to documentation errors
• additional information to expand upon and clarify existing documentation
• Technical Notes that provide up-to-the-minute information about Carbon updates, fixes and workarounds, and programming tips and techniques
• Technical Q & As offering answers to frequently asked questions about programming with Carbon

Important
To most quickly assist you in adopting Carbon in your software, Apple is supplying much of this information in preliminary form. Supplemental information and changes to documentation errors are posted to this site as soon as they become available. Hence, all of the information contained on this site is subject to change, and software implemented according to any of the documentation on this site should be tested with final operating system software.

To receive notification of new and updated developer documentation, sign up for ADC's free Online Program and receive their weekly Apple Developer Connection News e-mail newsletter. See our Programs & Products page for more details. A current sample newsletter is also available for viewing.